home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / classad1.zip / SYSOP.MAN < prev   
Text File  |  1993-03-03  |  15KB  |  330 lines
  1.  
  2.                           Classified Ads v1.0
  3.  
  4.                     Copyright 1993, PAROLE Software
  5.                           ALL RIGHTS RESERVED
  6.  
  7.                           The Parole Board BBS
  8.               (919) 965-4696 -> US Robotics Dual Standard
  9.  
  10.  
  11.                            PAROLE Software
  12.                            311 Buffalo Rd
  13.                            Clayton, NC  27520
  14.  
  15.                          (919) 965-9885 -> FAX
  16.               (919) 965-3600 -> Voice (Before 9:30 pm EST)
  17.  
  18.  
  19. DESCRIPTION:
  20.  
  21.      Classified Ads is a full-featured Ad listing door with support for
  22.      most major BBS user drop files.  It supports DOOR.SYS,
  23.      USERINFO.DAT, USERS.SYS, PCBOARD.SYS, SFDOORS.DAT, DORINFOx.DEF,
  24.      TRIBBS.SYS, CHAIN.TXT, CALLINFO.BBS and GTUSER.BBS.
  25.  
  26.      Users may enter the door and list their ad with their telephone
  27.      number and a short description of the service they are advertising.
  28.      SysOps may use 10 different categories of their on choice in the
  29.      door.
  30.  
  31. SUPPORT:
  32.  
  33.      Support for Classified Ads is available from several sources.  Messages
  34. may be left on The Parole Board BBS in the "PAROLE Software" conference
  35. or the Mustang! BBS in the "PRIVATE" conference.  If you feel that a
  36. message is not satisfactory you may call me voice.  (919) 965-3600
  37. Please call before 9:30pm EST as I am an early riser and need to get my
  38. "beauty sleep".
  39.  
  40. NOTE:  *PLEASE* check your file name and paths very carefully.  Ninety
  41. percent of the calls I get, are due to an incorrect path or CFG file
  42. setup.  Read the following instructions carefully before calling.
  43.  
  44. UPDATES:
  45.  
  46.      Updates are FREE to registered users and may be downloaded from The
  47. Parole Board BBS, Mustang! BBS and various other BBS systems.  Once
  48. registered, CatList updates are free for life.  If you wish an update on
  49. disk, send $3 to the address listed above and specify the disk size.
  50.  
  51.     If you are in a hurry and do not want to take the time to logon,
  52. enter " PAROLE SOFTWARE NOW! " at the name prompt.  It will give you
  53. access to the PAROLE Software file & support areas.  Don't forget the
  54. "!" on "NOW".
  55.  
  56. REGISTRATION:
  57.  
  58.       Registration is currently $15 and will entitle you to future
  59. upgrades.  I reserve the right to change the price in the future.
  60.  
  61. INSTALLATION:
  62.  
  63. Configuration file layout:
  64.  
  65. C:\PCB\PCBOARD.SYS             ─┐< For PCBoard systems using PCBOARD.SYS only
  66. C|\PCB\USERS.SYS                │< For PCBoard systems using USERS.SYS
  67. C:\BBS\CALLINFO.BBS             │< For Wildcat! systems (prior to v3.0)
  68. C:\BBS\CHAIN.TXT                │< For WWIV systems
  69. C:\BBS\GTUSER.BBS               │< For GT Power systems
  70. C:\WC\WCWORK\NODE1\USERINFO.DAT │< For Wildcat! 3.x+ systems.
  71. C:\BBS\DOOR.SYS                 │< For systems that support DOOR.SYS
  72. C:\BBS\DORINFOx.DEF             │< For QBBS/RBBS/RA. Replace x with Node #.
  73. C:\BBS\SFDOORS.DAT              │< For Spitfire systems.
  74. C:\BBS\TRIBBS.SYS              ─┘< For TriBBS systems.
  75. The Parole Board BBS
  76. Dennis
  77. Maidon
  78. 123456
  79. 14
  80. 10
  81. C:\WC30\BULL\BULL99.BBS
  82. [LEAVE BLANK] if "WC" or "PCB" in next line.
  83. WC
  84. YES
  85. C:\WC30
  86. C:\WC30\ADS
  87. YES
  88. YES
  89. E:\TEXT
  90.  
  91. On lines 12, 13 and 16, the trailing "\" is optional.  ADDOR.EXE will
  92. auto-detect it and act accordingly.
  93.  
  94.  1.  Path to BBS User file
  95.  2.  Your BBS name
  96.  3.  SysOp's first name.
  97.  4.  SysOp's last name.
  98.  5.  Serial Number if registered.
  99.  6.  Number of days for listings to remain active. {set to 3-5 for beta}
  100.  7.  Minimum Sec. Level to access door
  101.  8.  Path and name of Color bulletin. Be sure to add the name of the
  102.      bulletin that you want created on line 8 and 9.
  103.  9.  Path and name of ASCii bulletin
  104. 10.  Type of Bulletins (WC = Wildcat!3.x  PCB = PCBoard  N = ANSI/ASCii)
  105.      If you select the WC! or PCB type bulletins, you will only need to
  106.      supply a filename and path for the color bulletin.  You still must
  107.      include line 8.  You may leave it blank though.
  108. 11.  (Y/N)  Create the above bulletins.  This option ONLY works for
  109.      registered versions.  The bulletins are automatically created in
  110.      the DEMO versions.  They cannot be switched off.
  111. 12.  Path to ACTIVITY.LOG.  DO NOT put a filename on this line.  If you
  112.      are running Wildcat!3.x, ClassAds will write to the correct
  113.      ACTIVITY.xxx.  ClassAds will write to a file named ACTIVITY.xxx in
  114.      the directory you have specified if you are not running WC!.  The
  115.      "xxx" will correspond to the node number.
  116. 13.  If you select the option to have ClassAd write bulletins to a
  117.      separate directory, enter the directory path here. (Read DOCs for
  118.      further details.) See SPECIAL DIRECTORY INSTRUCTIONS below.  This
  119.      option is currently *ONLY* available to Wildcat!3.x systems.
  120. 14.  (Y/N) Create the bulletins in the special directory.  This option
  121.      ONLY works for the registered version.  These bulletins are NOT
  122.      created in the DEMO version.  They can not be switched on.
  123. 15.  (Y/N) Create the ASCii text file.  This file is automatically
  124.      created in the DEMO version.  It cannot be switched off.
  125. 16.  Path of the ASCii text file.  DO NOT put a filename here. ADDOR.EXE
  126.      will append "CLASSAD.TXT" to the path you specify.
  127.  
  128. All 16 lines must be present in the CFG file.  The lines that are not
  129. needed or used, may be blank but, they must be there.
  130.  
  131. NOTE: There are 2 additional lines necessary when using GTUSER.BBS. Since
  132.       this file does not provide the ComPort% and NodeNum% variables, you
  133.       will need to add them to this .CFG file on lines 5 and 6
  134.       respectively.
  135.  
  136. Classified Ads will operate on a multi-line BBS.  If you do not
  137. incorporate the environment variables defined below, you will need a
  138. separate CFG file for each node.  You must give each CFG its own
  139. distinct name.
  140.  
  141.      EX:  CLASSAD1.CFG   CLASSAD2.CFG   CLASSAD3.CFG
  142.  
  143. CLASSAD.LST
  144.  
  145.      You will need to edit the enclosed "CLASSAD.LST" and include the
  146. categories that suit your individual needs.  This file must contain 10
  147. lines.  Please use and ASCii editor such as Qedit to edit this file as
  148. some word processors add hidden control codes that could cause
  149. unpredictable results.   The maximum length of each line is 25
  150. characters.
  151.  
  152. SPECIAL DIRECTORY INSTRUCTIONS:
  153.  
  154.      This part is only available at the present time to WC!3.x systems.
  155. If, in the future, I can get some idea as to how to implement this on
  156. different systems, I will make it available.
  157.  
  158.  
  159. 13.  If you select the option to have ClassAd write bulletins to a
  160.      separate directory, enter the directory path here. (Read DOCs for
  161.      further details.)
  162.  
  163. To set this function up, you must enter your "Conference Definition"
  164. setup in MAKEWILD.  Create a message conference entitled "Classified
  165. Ads" or whatever title suits your fancy.  Give this conference its own
  166. Bulletin Directory path.  ADDOR.EXE will create the necessary
  167. BULLETIN.BBS and a bulletin for each record listed in the database.
  168. There is no special maintenance that the sysop needs do in this area.
  169. If a record is deleted in the database, ADDOR.EXE will delete the proper
  170. BULLx.BBS.
  171.  
  172. You will need to set the # of bulletins allowed in this area to the
  173. maximum number of bulletins that you expect.  ADDOR.EXE will allow up to
  174. 500 in the database.  WC! allows 999 in each bulletin conference.
  175.  
  176. ╔══════════╦════════════════════════════════════════════════════════╦══════════╗
  177. ║ 02-17-93 ║                 Conference Definition                  ║ 19:56:02 ║
  178. ╚══════════╩════════════════════════════════════════════════════════╩══════════╝
  179.                                                                                 
  180.         #           Description            #           Description              
  181.        ───   ─────────────────────────    ───   ─────────────────────────       
  182.          0 - !PRIVATE! Mail      [TPB]      1 - !PUBLIC! Mail       [TPB]       
  183.          2 - New Users!          [TPB]      3 - PAROLE Software     [TPB]       
  184.          4 - Classified Ads      [TPB]      5 -                                 
  185.                                                                                 
  186. ╔══════════════════════════════════════════════════════════════════════════════╗
  187. ║                 Copyright (c) 1989,93 Mustang Software, Inc.                 ║
  188. ║     [F1] Help - [F2] Edit Access - [F3] Copy - [F4] Global - [ESC] Exit      ║
  189. ╚══════════════════════════════════════════════════════════════════════════════╝
  190.  
  191. ╔══════════╦════════════════════════════════════════════════════════╦══════════╗
  192. ║ 02-17-93 ║                 Conference Definition                  ║ 19:56:07 ║
  193. ╒═══════════════════════════ CONFERENCE DESCRIPTION ═══════════════════════════╕
  194. │                                                                              │
  195. │  Conference Classified Ads      [TPB]   ┌────────── MISCELLANEOUS ─────────┐ │
  196. │                                         │ Conference sysop DENNIS MAIDON   │ │
  197. │ ┌─────────────── PATHS ───────────────┐ │ Mail type                Normal  │ │
  198. │ │ Bulletins      C:\WC30\ADS\         │ │ Max conference messages  100     │ │
  199. │ │ Questionnaires C:\WC30\QUES\        │ │ Max lines per message    150     │ │
  200. │ │ Menus          F:\MENU\             │ │ Number of questionnaires 3       │ │
  201. │ │ Help           F:\HELP\             │ │ Number of bulletins      50      │ │
  202. │ │ Display files  F:\DISP\             │ │ Check valid name         No      │ │
  203. │ │ Messages       C:\WC30\MSG\         │ │ File area access                 │ │
  204. │ └─────────────────────────────────────┘ └──────────────────────────────────┘ │
  205. │ ┌───────────────────────────────── TOGGLES ────────────────────────────────┐ │
  206. │ │ Allow message attachments        N    Allow return receipts            Y │ │
  207. │ │ Prompt to kill received messages Y    Allow private messages           Y │ │
  208. │ │ Allow high ascii characters      Y    Force all messages private       N │ │
  209. │ │ Allow message carbon copies      Y    Use alias names                  N │ │
  210. │ │ Read only conference             N                                       │ │
  211. │ └──────────────────────────────────────────────────────────────────────────┘ │
  212. ╘══════════════════════════════════════════════════════════════════════════════╛
  213. ║                 Copyright (c) 1989,93 Mustang Software, Inc.                 ║
  214. ║     [F1] Help - [F2] Edit Access - [F3] Copy - [F4] Global - [ESC] Exit      ║
  215. ╚══════════════════════════════════════════════════════════════════════════════╝
  216.  
  217. 14.  (Y/N) Create the bulletins in the special directory.  This option
  218.      ONLY works for the registered version.  These bulletins are NOT
  219.      created in the DEMO version.  They can not be switched on.
  220.  
  221. MISCELLANEOUS NOTES:
  222.  
  223. ADDOR.EXE requires DOS 3.x and up since all files are opened in SHARED mode.
  224.  
  225. When using PCBOARD.SYS, ADDOR.EXE also accesses the USERS file.
  226.  
  227. When using USERS.SYS, ADDOR.EXE also accesses PCBOARD.SYS, PCBOARD.DAT and the
  228. USERS file.
  229.  
  230. The DOOR.SYS used by ADDOR.EXE is the standard 52 line GAP (tm) file.
  231.  
  232. The CALLINFO.BBS used by ADDOR.EXE currently contains 36 lines.
  233.  
  234. WILDCAT! EXTRA:
  235.  
  236. If ADDOR.EXE updates the Text file, it will write a 0-byte file to the
  237. door directory named, CHANGE.FIL.  If you use Transcan to update the WC!
  238. database, you can test for this file and only run TranScan when needed.
  239. Be sure to delete it after running transcan.  There may be utilities
  240. that will update the databases of various other BBS systems.  CHANGE.FIL
  241. is created whenever the CLASSAD.TXT is updated.
  242.  
  243. @ECHO OFF
  244. CLS
  245. D:
  246. CD \DOOR\AD
  247. ADDOR AD.CFG /%WCIRQID%
  248. IF EXIST D:\DOOR\AD\CHANGE.FIL TS E:\TEXT\CLASSAD.TXT /TK,T
  249. IF EXIST D:\DOOR\AD\CHANGE.FIL ERASE D:\DOOR\AD\CHANGE.FIL
  250.  
  251. Fossil Driver Support
  252. ---------------------
  253. ADDOR.EXE supports the use of Fossil drivers.  To tell your Door to use the
  254. Fossil driver instead of the standard COM ports, just put /FD on the command
  255. line when running the door. For example:
  256.      MYDOOR MYDOOR.CFG /FD
  257. indicates that a Fossil driver is present and should be used. If no Fossil
  258. driver is detected, ADDOR.EXE will print a message to that effect and exit
  259. the door gracefully.
  260.  
  261. Environment Variables
  262. ---------------------
  263. ADDOR.EXE supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  264. COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  265. number after the configuration filename. Let's assume your Door is
  266. called FOOBAR and you want to use COM1 and IRQ5. The command line
  267. passed to your Door would be:
  268.     FOOBAR FOOBAR.CFG /5  or
  269.     FOOBAR FOOBAR.CFG /%IRQ%  for the environment variable.
  270. The /5 tells ADDOR.EXE to use IRQ5 rather than the standard IRQ4 that
  271. is normally used with COM1. No /x parameter is needed for the standard IRQ's.
  272.  
  273. When specifying the location of the system file on line 1 of the doors .CFG
  274. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  275. and %wcnodeid%. Some examples:
  276.  
  277.  PCBoard: 
  278.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  279.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  280.  
  281.  Wildcat!:
  282.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  283.  
  284. Non-PCBoard systems may use the PCB environment variables by setting them
  285. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  286.  SET PCBDRIVE=C:
  287.  SET PCBDIR=\BBSDIR
  288.  SET PCBNODE=1
  289.  
  290. DISCLAIMER:
  291.  
  292.                               LEGALITIES
  293.                               __________
  294.  
  295.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  296.       WITHOUT WARRANTY, EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  297.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  298.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  299.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  300.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  301.       OR BREACH OF ANY WARRANTY.
  302.  
  303. DISTRIBUTION:
  304.  
  305.      The current release of Classified Ads may be found on The Parole
  306. Board BBS and will be available to all first time callers.  I will also
  307. upload it to select BBSs across the country.  If you wish to logon and
  308. access the PAROLE Software files, you may logon on under the name
  309. "PAROLE SOFTWARE" and use the password "NOW!".  Please note the "!".
  310.  
  311. NOTES:
  312.  
  313.      Classified Ads is written and compiled using Visual Basic for DOS
  314.      v1.0 (Professional Version)  VB/DOS is copyright 1992, MicroSoft
  315.      Inc.
  316.  
  317.      Wildcat! is Copyright 1986,1993 Mustang Software Inc.
  318.  
  319.      Many thanks to the SysOps that helped to test this door product.
  320.      Their names and BBS info may be viewed by selecting "$" from the
  321.      Main Menu.
  322.  
  323.      Qedit is Copyright (C) 1985-1993 by SemWare, all rights reserved
  324.  
  325.      This door was written using the DoorFrame module by Ted Freeman.
  326.  
  327.      Bill Clinton for making all this necessary.  I need the $$$ to pay
  328.      his darn taxes.
  329.  
  330.